System Booster

home *** CD-ROM | disk | FTP | other *** search

/ System Booster / System Booster.iso / Archives / ForCLI / DirKing.lha / DirKing / UserManual.doc < prev

Wrap

Text File | 1993-03-07 | 88.7 KB | 1,857 lines

__ / //// __ /// \ \ /// < < <<< DirKing v2.12e >>> > > \ \/// \__//// USER MANUAL - Release : 05-Mar-93 Copyright ©1990-1993 Chris P. Vandierendonck, [AmiSYS]. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Copyright Notice ~~~~~~~~~~~~~~~~ DirKing is released as SHAREWARE, not excluding the copyright and all other rights which remain with the author Chris P. Vandierendonck. The program and files included with this distribution are not freely distributable. Shareware means that you must register if you use the program. Prior written permission from the author is required to distribute DirKing or to use it in commercial releases, on coverdisks or diskmagazines. When distributed, all files must be kept together, in the original unmodified form. (AmigaDOS is a trademark of Commodore Amiga Inc.) Disclaimer ~~~~~~~~~~ DirKing is provided "AS IS", WITHOUT ANY WARRANTY to its quality, performance or fitness for a particular purpose. In no event shall the author be liable or responsible to the user or any other person, for any kind of damage caused by the use of this software. Registering for DirKing is necessary to ensure future development. More information on how to register can be found in this document or in the "Registration.doc". Registrations, suggestions, remarks and bug reports about this program can be send to the following address : Chris Vandierendonck Koning Albertstraat 188 B-8210 VELDEGEM BELGIUM Preface ~~~~~~~ DirKing is a feature packed directory list program, which overlaps the AmigaDOS commands List, Dir and Info. It has all the features of the AmigaDOS commands, but also includes many enhancements. The program supports different filter for reading a directory, allows complex sorting and gives full control on the listing format. DirKing is reentrant, so it can be made resident. System Requirements ~~~~~~~~~~~~~~~~~~~ DirKing v2.12 requires AmigaDOS v1.2 or higher. DirKing v2.1xe (English) User Manual - Page 1 Shareware Registration ~~~~~~~~~~~~~~~~~~~~~~ Registering for DirKing ensures future development of this software. You can register under the following conditions : o See "Registration.doc" for more information, and for the registration fee in US dollars, GB pounds, German marks or Belgian franks. o The base fee is US$ 12.00. This fee covers a registered version of DirKing (English, German, French or Ducth version) and one free update. The following additional products can only be obtained when you pay the base fee, or if you're already a registered user of DirKing : o You can order DirKing in other language versions (English, German, French or Dutch) at the price of US$ 6.00. NOTE: the one free update in the base registration fee, does NOT apply to these extra ordered versions! REMARK: only the program itself supports these languages, the DirKing documents are only in the english language (but the user manual is adapted for those functions which use language specific arguments). o A laser printed copy of this user manual, and related documents can be obtained for US$ 6.00 (price per version). o All above mentioned amounts include P&P. So you don't have to pay extra, wherever you live. o You can transfer the money in three ways : - in cash (PAPER money ONLY) -> fast and cheap; - by EuroCheck (only in Belgian Francs [BEF] !!); - by (international) postal money order. DO NOT SEND FOREIGN BANKCHECKS, since it's too expensive too clear them. o If possible, please use a printout of the included 'RegForm' file to register. o From the moment I receive the registration (order) form and the necessary payments, your order will be processed. DirKing v2.1xe (English) User Manual - Page 2 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ USER MANUAL CONTENTS ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ §1 Preliminary remarks. . . . . . . . . . . . . . . . . . . 4 §2 DirKing keyword and argument syntax. . . . . . . . . . . 5 §3 Directory scanning . . . . . . . . . . . . . . . . . . . 5 A. Specifying the directory path . . . . . . . . . . . . 5 A.1. Normal directory paths . . . . . . . . . . . . . 5 a. General use . . . . . . . . . . . . . . . . . 5 b. Advanced use : recursive directory paths. . . 6 A.2. Deep level pattern matching. . . . . . . . . . . 6 B. Filtering directory information . . . . . . . . . . . 7 B.1. Global filters . . . . . . . . . . . . . . . . . 8 B.2. Filter options . . . . . . . . . . . . . . . . . 9 B.3. File- and directoryname filtering. . . . . . . . 9 B.4. Conditional date filters . . . . . . . . . . . . 10 C. Tracing the scanning process. . . . . . . . . . . . . 11 §4 Directory information. . . . . . . . . . . . . . . . . . 12 A. Volume (disk) information . . . . . . . . . . . . . . 12 B. Listing header/end information. . . . . . . . . . . . 14 C. File- and directory fields. . . . . . . . . . . . . . 15 §5 Directory sorting. . . . . . . . . . . . . . . . . . . . 17 §6 Listing formatting . . . . . . . . . . . . . . . . . . . 18 A. Listing table formatting. . . . . . . . . . . . . . . 18 A.1. Setting the listing table width. . . . . . . . . 18 A.2. Formatting the listing table . . . . . . . . . . 18 B. Predefined listing table formats. . . . . . . . . . . 20 C. Free formatting and script generation (LFORMAT) . . . 20 §7 DirKing MULTI-mode (multiple directory scanning) . . . . 22 §8 Listing styles . . . . . . . . . . . . . . . . . . . . . 23 A. Information format. . . . . . . . . . . . . . . . . . 23 B. Listing print styles. . . . . . . . . . . . . . . . . 24 §9 Listing output redirection . . . . . . . . . . . . . . . 25 §10 Listing paging . . . . . . . . . . . . . . . . . . . . . 26 §11 Disk identification coding support . . . . . . . . . . . 27 §12 DirKing program information. . . . . . . . . . . . . . . 28 Appendix: DirKing keyword reference. . . . . . . . . . . . . 29 DirKing v2.1xe (English) User Manual - Page 3 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ DIRKING USER MANUAL ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ §1 Preliminary remarks. ~~~~~~~~~~~~~~~~~~~~ o Although DirKing can be used in the same way as the AmigaDOS command List, the real power and flexibility of DirKing is found in the additional features. For the more advanced features, you'll need to experiment a bit, but you'll soon get the hang of it. o Like the AmigaDOS command List, DirKing can only be used from a Shell (CLI) or script. DirKing can also be made resident by using the AmigaDOS command 'Resident', since DirKing is reentrant. o From the DirKing usage prompt you'll notice that all argument keywords are printed in upper case. This doesn't mean you have to type them as well in upper case, lower case will do since DirKing doesn't parse the arguments on a case sensitive basis. The rule is that everything may be printed in lower case, unless explicitly stated otherwise. Except for one argument, all arguments can be typed on the command line in any order you want. This means that for example you could type in the directory path at the end. DirKing will still recognize it. Some options however, consist of two separate arguments, which are a keyword argument and a data-argument. Naturally these arguments have to typed in that order. The exception as mentioned earlier, is the LFORMAT argument. This argument has always to be typed last, since everything after the keyword is regarded as being the format string. Due to the fact that the arguments can be typed in any order, you must be careful not to override a previous typed option. For instance, if you first type 'INCL' and then 'EXCL', the latter can alter the settings of the INCL option if you don't watch it. o Some DirKing options need a data-argument in the form of a string. In case this string should contain spaces, then you've to enclose it between double quotation marks. o DirKing also supports pattern matching. In this version not all AmigaDOS wildcards are supported, but I don't think you'll need those exotic wildcards anyway. (Although a future planned AmigaDOS 2 version only, will support all wildcards.) The following wildcards are supported by DirKing : ? : matches just one character; # : the next character may occur zero or more times; ' : take the next character literally; * : although not supported by AmigaDOS, DirKing accepts this equivalent for '#?'. (This wildcard is also used in all examples.) DirKing v2.1xe (English) User Manual - Page 4 | : separator for using multiple patterns. o Throughout this manual, you'll find numerous examples to demonstrate the use of DirKing's features. Those examples are always printed after '|'s. What has to typed on the command line, is enclosed between single quotation marks ('). I didn't use double quotation marks ("), since they may sometimes be part of a data-argument. §2 DirKing keyword and argument syntax. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ When you use the question mark (?) on the command line, DirKing will print the usage prompt (which will remind you of the correct argument syntax) : [PATH] [[F|D|]<path|patt>] [QUICK] [ALL] [TOLEVEL <#>] [DIRS] [FILES] [READ [F|D|]<pattern>] [PASS [F|D|]<pattern>] [SUB [F|D|]<string>] [SINCE "[F|D|]<[DOSdate] [time]>"] [UPTO "[F|D|]<[DOSdate] [time]>"] [FROM [F|D|]<ch> TO <ch>] [INCL {fkbladtc}] [EXCL {fkbladtc}] [DESC] [FD|DF|MIX] [SORT {nksadtc}] [NOSORT] [FULLPATH] [HEAD {fdvpimtse}] [DISKINFO] [DISKID <str>] [BARELIST] [NOHEAD] [MAXHEAD] [NOSTAT] [ENDMSG] [EXPAND] [MAXWIDTH <#>] [SHOWLEVEL] [NEWPAGE [[{th}]<#>]] [DIRSTYLE [r|i|b|y|f|a|e][r|i|b|y|f|a|e]] [PRTSTYLE {rdlbpes}] [PRT] [TO <file>] [DATES] [BINFLAGS] [HEXVAL] [LISTF <0..4>] [DATEF <0..7>] [TIMEF <0..3>] [LISTORD <fmt>] [DFORMAT <fmtstr>] [TFORMAT <fmtstr>] [DISKUSE] [TRACE] [MULTI] [VERSION] [LFORMAT <fmtstr>] §3 Directory scanning. ~~~~~~~~~~~~~~~~~~~ The following arguments direct the way the directory is read. By default DirKing will only read the files and directories of the current directory or the specified path. Thus DirKing won't descend in the sub-directories. A. Specifying the directory path. A.1. Normal directory paths. o [[F|D|]<path|patt>] a. General use. If you don't specify a path to a directory (or file) to scan, then DirKing will scan your Shell's current directory. | current directory : 'Workbench:c' | 'DirKing' : will read the 'Workbench:c' directory If you do specify a path, then DirKing will obviously check if this path exists, and if so, list its contents. This path must be a valid AmigaDOS path, otherwise you'll cause a DOS error. | 'DirKing workbench:s' : will read 'Workbench:S' It's also possible to use pattern matching. You can do this for both a specified path or the current directory. Normally this pattern will be effective on both files and directories, but you can alter this by using the '[F]' or the '[D]' option. To DirKing v2.1xe (English) User Manual - Page 5 To select one of these options, you have to put an 'F' or an 'D' at the beginning of the path. IMPORTANT: this option code has always to be typed in UPPER CASE and must be the first character of the path! Otherwise DirKing will interprete it as being part of the path. The specified patterns will be effective during the whole scanning process. Thus not just for the scanned directory, but for all further read sub-directories. If you only want the pattern to be effective in one directory level, then you must use "deep level pattern matching", which is explained later. | 'DirKing workbench:*s*' : only read those files and | directories which contain an 's' in their name | 'DirKing Fworkbench:*a*|*b*' : only read those files | which contain an 'a' or 'b' in their name. (All | directories will be accepted. b. Advanced use : recursive directory-paths. Recursive paths to a directory or a file always start from the current directory. To climb up the directory tree (recurse) you have to make use of the '/' and ':' characters. Using ':' goes back to the root of the volume on which the current directory is situated. | current directory : 'Workbench:devs/keymaps' | 'DirKing :' : DirKing use 'Workbench:' as the path. The '/' character refers to a parent directory of your current directory. The more '/'s you use, the higher you climb the directory tree. How many '/'s you may use, depends on how far you're away from the root directory. If you enter more '/'s than there are parent directories, then DirKing will fail and output an invalid path error! | current directory : 'Workbench:devs/keymaps' | 'DirKing /' : read the 'Workbench:devs' directory | 'DirKing //' : read the 'Workbench:' directory | 'DirKing ///' : error, no parent of 'Workbench:' exists o [PATH] The only function of PATH is to inform DirKing that the argument following is the path, and not an argument keyword. PATH is only useful in case you want to scan a sub-directory of your current directory which has the same name as an argument keyword. If PATH wouldn't be used in such a situation, then DirKing would interprete your path as an argument keyword, and not as the path (the AmigaDOS commands 'List' and 'Dirs' make this mistake). A.2. Deep level pattern matching. The term 'deep level pattern matching' is the only way I can describe the following feature. As mentioned above, this kind of pattern matching is more suited when DirKing has to descend the directory tree. Since you can specify patterns for upto 32 DirKing v2.1xe (English) User Manual - Page 6 directory levels. The patterns are typed in the place where you would normally type the name of a directory in the path. When nothing is typed in this place then this means that there's no pattern for that directory level. Note: the patterns are also effective on both files and directories, unless you make use of the 'F' or 'D' options. | 'DirKing workbench:*s*/p*|*x*' will be interpreted as : | path = 'workbench:', | pattern for level 0 = '*s*', for level 1 = 'p*' & '*x*' | 'DirKing workbench:s/p*' will be interpreted as : | path = 'workbench:s', pattern for level 0 = 'p*' | 'DirKing workbench:/p*|*x*//*c*|*y' is interpreted as : | path = 'workbench:', | pattern for level 0 = '' (no pattern), | " for level 1 = 'p*' & '*x*', | " for level 2 = '', (no pattern) | " for level 3 = '*c*' & '*y', 'Deep level pattern matching' can also be used in conjunction with a recursive path. It then is very important to have a clear notion of what you enter, since DirKing has to use a part of your path string as the path to scan, and the rest of it as the patterns. The recursive indicators ':' and '/' should always be at the front of the path string, without any characters in between. From the moment another character is typed in, then from thereon the string will be used as a path (with or without deep level pattern matching). | 'DirKing :/*c*' means path = ':' or volume (root) | level 0 pattern = '' (no pattern), | level 1 pattern = '*c*' | current directory = 'Workbench:devs/keymaps' | 'DirKing //*s*//*y*' means path = 'Workbench:' | level 0 pattern = '*s*', | level 1 pattern = '' (no pattern), | level 2 pattern = '*y*' | current directory = 'Workbench:devs/keymaps' | 'DirKing //devs//*s*//*y*' means path = 'Workbench:devs' | level 0 pattern = '' (no pattern), | level 1 pattern = '*s*', | level 2 pattern = '' (no pattern), | level 3 pattern = '*y*' I know it gets very complicated, but the only way to fully master this feature is to experiment a bit. The best way to do this is by sending the listing of a large directory tree to the printer, and then starting to experiment on that directory with its listing in front of you. B. Filtering directory information. Although you can filter what has to be read by using patterns in the path, most of the time you want more than that. For this DirKing v2.1xe (English) User Manual - Page 7 this purpose DirKing supports three kinds of powerful filters, which are explained below. B.1. Global filters. As their name suggest, these filters have an overall control on the scanning process. With most you'll be familiar, since they're also present in the AmigaDOS directory list commands. o [ALL] By default Dirking will only read one directory level (which is the Shell's current directory or a specified path). If you use ALL then DirKing will descend into all sub-directories it finds, until no more are found. | 'DirKing Workbench: ALL' : the whole Workbench disk will | be scanned. o [DIRS] At first glance one would assume that DirKing will only read directories. In a way this is true, but it's better to interprete this argument so that DirKing may include directories. (Because if you also use 'FILES', then files will also be included.). The 'DIRS' option in conjunction with 'ALL' is a good way to get a clear view of the directory tree (since no files are listed). o [FILES] This DirKing option acts the same as DIRS, but now for files. If this option is used, then DirKing will only read files, and ignore all directories. This means that DirKing will only read one directory level, and that the options "ALL" and "TOLEVEL" won't work. Exception: the above isn't true for the LFORMAT option. Here the FILES option means that only files will be listed. If directories are encountered, then DirKing will enter them if the "ALL" or "TOLEVEL" option is used. o [TOLEVEL <#>] This option works in the same way as 'ALL', except that 'TOLEVEL' specifies how many directory levels may be scanned. I speak of 'may' because it doesn't matter if the TOLEVEL value is greater than the actual number of directory levels present. | Assume current directory is 'Workbench:Devs' | 'DirKing TOLEVEL 0' : will only read entries in this | directory level, without descending down the directory | tree. | 'DirKing TOLEVEL 1' : does the same, but will also read | the 'KeyMaps' and 'Printers' directories. DirKing v2.1xe (English) User Manual - Page 8 B.2. Filter options. -> [F|D|] All the following filters (including the conditional date filters) support the use of 'F', 'D' and '' options. The use of these options has already been discussed with the path, but when used with filters, they add another dimension. First I'd like to remind you of the meaning of the three options : - '' : if you don't enter an option code, then DirKing will use the filter on both files and directories; - 'F' : the filter will only be used for files; - 'D' : the filter will only be used for directories. Note: the option code must always be typed in UPPER CASE, and always be the first character of the data-argument! The options used with filters, add another dimension to that filter. Since you can use the filter upto three times on the command line, providing that each filter argument has a different option. In other words you can enter a filter for both files and directories, one for files only, and another for directories. B.3. File- and directoryname filtering. The following filters operate on the name of files and directories, thus presenting more powerful filtering than the previous filter type. o [READ [F|D|]<pattern>] This argument instructs DirKing to only read (include) those directory entries (files and/or directories) which match the given pattern(s). An unlimited number of patterns can be specified. The vertical bar "|" is used to separate these patterns. (If one of the patterns should contain spaces, then you must enclose the whole data-argument between quotation marks.) | 'READ *s*' : include only those directories and files if | their name includes 's'. | 'READ *s*|*a*' : include only those directories and files | if their name either includes 's' or 'a'. | 'READ F*a* READ D*b* READ *c*' : | Files are only included if their name matches the '*a*' or | the '*c*' patterns. Directories are only included if their | name matches the '*b*' or the '*c*' patterns. | 'READ F*a*|*b*|*c*' : | Files are only included if their name matches one of the | three specifies patterns (*a*, *b*, *c*). All directories | will be included, since this argument is only effective | for files! o [PASS [F|D|]<pattern>] The PASS argument works in the same way as the READ argument, except that all directory entries (files and/or directories) DirKing v2.1xe (English) User Manual - Page 9 that match the given pattern(s) are ignored (excluded). | 'PASS *s*|*a*' : ignore those directories and files if | their name either includes 's' or 'a'. | 'PASS F*a* PASS D*b* PASS *c*' : | Files are ignored if their name matches the '*a*' or the | '*c*' patterns. Directories are ignored if their name | matches the '*b*' or the '*c*' patterns. o [SUB [F|D|]<string>] In order to be included in the listing, the names of the files and/or directories must contain the specified string(s). | 'SUB s|a' : include only those directories and files if | their name either contains 's' or 'a'. | 'SUB Fa|d SUB Db SUB c' : | Files are only included if their name contains 'a', 'd' or | 'c'. Directories are only included if their name contains | 'b' or 'c'. o [FROM [F|D|]<ch> TO <ch>] The 'FROM TO' argument enables filtering on the first character of the name of files and/or directories. Since AmigaDOS names aren't handled case sensitive, typing 'A' is the same as typing 'a'. The <ch>aracter is only valid if it's in the range [0..9] or [a..z]. | 'FROM a TO d' : only include directories and files, if the | first character of their name is equal or greater than | 'a', but not greater than 'd'. | 'FROM 5 TO a' : only include directories and files, if the | first character of their name is equal or greater than | '5', but not greater than 'a'. | 'FROM Fa TO d' : only include files if the first character | of their name is equal or greater than 'a' but not greater | than 'd'. All directories will be included, since this | filter doesn't apply to them. If the TO <ch>aracter is smaller than the FROM <ch>aracter, then this TO <ch>aracter will be replaced by the last valid character in the range. | 'FROM s TO a' : will be interpreted as 'FROM s TO z'. B.4. Conditional date filters. Conditional dates provide filters for the date- and timestamp of a file or directory. The syntax of the conditional date can be one of the following : 1° DOSdate : only a datestamp is given, in the usual AmigaDOS format, which is DD-MMM-YY (e.g. 14-aug-92). If DirKing v2.1xe (English) User Manual - Page 10 the date is within the last week of the current date, then you may use the actual dayname of that date (Sunday...Saturday); you may also use 'Today' and 'Yesterday'. The dates after the current date can be replaced by 'Tomorrow' and 'Future' (represents the day after tomorrow and later). 2° time : only a timestamp is given, in the usual AmigaDOS format, which is HH:MM:SS (e.g. 18:15:42). (The seconds can be omitted, in which case '00' is used). 3° DOSdate & time : a date- and timestamp is given, in the above specified formats. (Note that you can also enter the date- and timestamp in reverse order.) REMARK: the date- and timestamp must be typed in the above mentioned formats, otherwise DirKing won't recognize your date/timestamp! o [SINCE "[F|D|]<[DOSdate] [time]>"] Using SINCE means that only those directory entries (files and/or directories) will be included if their date- and/or timestamp is equal or later than the given conditional date. | 'SINCE 14-aug-92' : include only files and directories | which were created on or after 14 August 1992. | 'SINCE 14:30:00' : include only files and directories | which were created on or after 14:30:00. | 'SINCE "14-aug-92 14:30:00"' : include only files and | directories which were created on or after 14-Aug-92, | 14:30:00. | Assume that today is 16-Aug-92 | 'SINCE yesterday' : include only files and directories | which were created on or after 15-Aug-92. | 'SINCE Ftoday' : include only files that were created | today or later. All directories found will be included, | since this filter is only effective for files. o [UPTO "[F|D|]<[DOSdate] [time]>"] Everything said for SINCE applies for UPTO, with this difference that now only files/directories will be included if their date/timestamp is equal or earlier than the conditional date/timestamp. C. Tracing the scanning process. o [TRACE] This is a rather exotic feature of DirKing. TRACE is used to monitor the scanning process. This option is extremely useful when scanning large directories, and you want to know what's DirKing v2.1xe (English) User Manual - Page 11 going on. The information printed consists of the following : - the currently scanned path; - the number of directories included so far, and the last one found; - the number of files included so far, and the last one found; Note: this feature will slightly slow down the scanning process, but once you used it, you'll be addicted to it. §4 Directory information. ~~~~~~~~~~~~~~~~~~~~~~ By default, DirKing will print the listing in roughly the same format as the AmigaDOS 'List' command, but with more style and information. First of all DirKing will print the scanned path and the date/timestamp of the listing. Then the actual listing is printed in a table form, with a title line indicating what all the printed fields mean (the List command doesn't print such a title line!). After the listing has been printed, a statistic line will be printed, which states the number of files and directories found, the amount of bytes and blocks used by the files and the number of bytes free on the volume. This default listing format can be altered by the options as described below. But for good understanding, it's necessary to explain some terms used : o DirectoryEntry : refers to files and directories; o Field : each separate information of a directory entry (e.g. name, blocks used, datestamp,...); o Listing : what DirKing prints on the scanned directory (consists of the listing header, the actual listing and the listing end); o ListingHeader : a block of information about the scanned directory (and volume); o ActualListing : that section of the listing, only holding the directory entries, including the title line (which states the meaning of the different fields); o ListingEnd : the block of information printed at the end of the listing (thus after the actual listing). o DiskInfoBlock : a block of extensive information on the volume that was accessed to read the directory; A. Volume (disk) information. o [DISKINFO] The DISKINFO option can be compared with the AmigaDOS command 'Info', except that it gives more information than this command. The information is printed in a block consisting of three lines of information : Line_1 : - 'Volume' : volume name; - 'Created' : date/time stamp of creation; Line_2 : - 'RootKey' : block number of the root directory; DirKing v2.1xe (English) User Manual - Page 12 - 'DiskSize' : number of blocks on the disk; - 'BlockSize' : number of bytes in a block; - 'BlocksFree' : number of blocks free on the disk; - 'BytesFree' : number of bytes free on the disk; - 'Errors' : number of soft-errors on the disk; - 'DiskStatus' : status of the disk (Read/Write, ReadOnly, Validating); - 'DOSType' : DOS type of the disk (OFS:OldFiling- System, FFS:FastFilingSystem, KICK: KickstartDisk,MSDOS:MS-DOSdisk,IOFS: InterOFSdisk, IFFS:InterFFSdisk); Line_3 : - 'Most Recent DateStamp' : not filled; - 'TotalFiles' : not filled; - 'TotalDirs' : not filled; - 'BlocksUsed' : number of blocks used on the disk; - 'BytesUsed' : number of bytes used on the disk; - 'Full' : disk full percentage. Note: the lines 2 and 3 form the 'DiskInfoBlock'. Three items of line 3 aren't filled, because DirKing doesn't scan the disk when 'DISKINFO' is selected. If you do want these items filled, then you must use 'HEAD vpi EXCL f' instead of 'DISKINFO' (for more details on these arguments, see later). IMPORTANT: when 'DISKINFO' is used, then all other DirKing options will be ignored, except for the path argument (DirKing must know from which volume you want information). Since DirKing doesn't read a directory, the volume information is given instantly. | 'DirKing DISKINFO' : gives information about the volume on | which the current directory is | situated. | 'DirKing DF1: DISKINFO' : gives information on the disk | which is inserted in drive | 'DF1:'. o [DISKUSE] By default the 'blocksUsed' and 'bytesUsed' infofields show how many blocks and bytes are used by the files found in the scanned directory. This however isn't the exact value of used diskspace. This is where the new option DISKUSE makes an entry. When this option is used, then the 'blocksUsed' infofield will show the exact number of blocks used by the files and directories in the scanned directory. In other words, this value also includes the blocks used by DOS (header blocks) to maintain the directory tree. The 'bytesUsed' is then equal to the number of blocks used, multiplied by the blocksize. Now DirKing gives the same value as the 'List' command. NOTE: the above mentioned infofields can be found in the listing header with the DiskInfoBlock or in the listing end with the statistic line. DirKing v2.1xe (English) User Manual - Page 13 B. Listing header/end information. By default DirKing will use a listing header stating the following information : scanned directory (using the correct upper/lower case notation) and the date/timestamp of the listing. The listing end consists of a statistic line, giving the number of files and directories found, and the number of bytes and blocks used by them. With the following options, you can alter what is printed as a listing header an as a listing end. o [FULLPATH] When you normally enter a path to a directory or file, you'll use lower case characters (since AmigaDOS isn't case sensitive on this subject). However, DirKing will search for the correct upper/lower case notation of that path, before printing it in the listing. By default, DirKing will only correct the path that you've specified. It won't look for the correct path from the root on. Sometimes you'll want to know the correct path starting from the volume-root. You can do this by using FULLPATH. This option instructs DirKing to construct the path from the volume-root upto the directory or file specified. | Assume we're scanning your Workbench (system) disk. | 'DirKing devs:' : DirKing will print 'DEVS:' as the | scanned path. | 'DirKing devs: FULLPATH' : 'Workbench:Devs' is printed as | the scanned path. | Assume current directory is 'Workbench:Devs'. | 'DirKing' : (read current directory) '' is printed as the | scanned path. | 'DirKing FULLPATH' : 'Workbench:Devs' is printed as the | scanned path. | Assume current directory is 'Workbench:Devs' | 'DirKing keymaps' : will read the 'Workbench:Devs/Keymaps' | directory, where DirKing will print | 'Keymaps' as the scanned path. | 'DirKing keymaps FULLPATH' : reads the same directory, but | 'Workbench:Devs/Keymaps' will | be printed as the path read. | Assume your Workbench disk in drive 'DF1:'. | 'DirKing df1:' : 'DF1:' is printed as the scanned path. | 'DirKing df1: FULLPATH' : 'Workbench:' is printed as the | scanned path. o [HEAD {fdvpimtse}] The default listing header and listing end have already been explained at the beginning of '§4B'. The HEAD option now allows you to specify what information you want in the listing header and the listing end. Note: although the argument keyword is called 'HEAD', it DirKing v2.1xe (English) User Manual - Page 14 defines both the listing header and listing end! To define which listing header and listing end you want, you have to use the following codes (the codes are given in the order they'll appear in the header) : > Listing head codes - F : display the maximum listing head; this code is the equivalent of using 'HEAD dvpit'. - D : print date and time of scanning; - V : print name and creation date of the accessed volume (disk); - P : if a path was scanned (any path, except when it only represents a volume or device name, or an assign) then print it; - I : print the DiskInfoBlock as explained with the 'DISKINFO' option; - M : print the default listing header line; - T : print the title above the listing table; > Listing end codes - E : print the '~~~~~ End of Directory ~~~~~' message at the end. - S : print the statistic line at the end of the listing (default listing end); o [MAXHEAD] This argument is equal to using 'HEAD f' or 'HEAD dvpit'. o [NOHEAD] If used, then no listing head will be printed above the listing, except for the listing title. o [BARELIST] Only the actual listing will be printed, without the title line. In other words only the directory entries are given. o [NOSTAT] Prevents that the statistic line is printed at the end of the listing. This option will primarily be used to suppress the default listing end (which is this statistic line). o [ENDMSG] Lets DirKing print the '~~~~ End of Directory ~~~~' message after the actual listing. C. File- and directory fields. The following arguments define which fields of a directory entry are printed. By default DirKing will print the following fields in the given order (the names between '' are the ones printed in the listing title line) : DirKing v2.1xe (English) User Manual - Page 15 - 'FileName' : name of a file or directory; - 'Keys' : the disk key (block number of file/directory header); - 'Blocks' : blocks used by a file (for directories 'Dir' is printed instead); - 'Bytes' : bytes used by a file (for directories 'Dir' is printed instead); - 'Flags' : the file/directory attributes (protection flags); - 'Date' : datestamp of file/directory; - 'Time' : timestamp of file/directory. Note: filenotes (comments) aren't printed in the default setting. You have to use 'INCL' to include them. o [QUICK] If 'QUICK' is used the only the file/directory name field is printed. o [INCL {fnkbladtc}] The INCL option is used to specify which fields you want to be printed in the actual listing. The following field codes are defined : - F : the equivalent of 'INCL nkbladtc' (in other words prints all fields); - N : include file/directory name; - K : include file/directory diskkey; - B : include filesize in blocks (prints 'Dir' for dirs.); - L : include filesize in bytes (prints 'Dir' for dirs.); - A : include file/directory attributes (protectionflags); - D : include file/directory datestamp; - T : include file/directory timestamp; - C : include file/directory filenote (comment); the file- note is only printed when one is present. | 'INCL nd' : only print the name and datestamp fields. | 'INCL n' : only print name field (equivalent of 'QUICK'). | 'INCL nkbladt' : is the same as the default setting | (explained earlier). o [EXCL {fnkbladtc}] The 'EXCL' option is used to specify which fields you don't want to be printed. 'EXCL' is only useful for excluding fields from the default settings, because if you've used 'INCL' earlier, then you've already specified which fields you want. | 'EXCL f' : you'll get an empty listing, only the listing | header and listing end will be printed. | 'EXCL kbladt' : is the same as using the QUICK argument, | in other words, only the name of the files | and directories is printed. DirKing v2.1xe (English) User Manual - Page 16 §5 Directory sorting. ~~~~~~~~~~~~~~~~~~ By default DirKing will sort the names of files and directories in ascending alphabetical order. In the listing itself, all files will be printed first, and last the directories. o [SORT {nksadtc}] DirKing is able to execute a complex sort on all the fields of a directory entry. On which field to sort, is specified by their appropriate code. Important however is to type these codes in the order you want DirKing to sort the fields. The following codes (and fields) are supported : - N : sort on file/directory names; - K : sort on file/directory diskkey; - S : sort on filesize (dirs have no size); - A : sort on file/directory attributes (sorts on the binary value of these attributes); - D : sort on file/directory datestamp; - T : sort on file/directory timestamp; - C : sort on file/directory filenote if it's present. REMARK: since AmigaDOS names of files and directories are unique in the same directory level, any sort codes after the 'N' code aren't executed (because this would be a waste of valuable processing time!). Note: specifying the fields to sort on, doesn't mean that these items will be printed in the listing. What is actually printed depends on the options explained in '§4C'. | 'SORT ds' : first sort on the date, then on the size. | 'SORT tna' : first sort on the time, then on the name. No | sort is executed on the attributes, since | filenames are unique. o [NOSORT] If used then the listing won't be sorted. Thus giving a slight scanning speed increase. o [DESC] By default the directory is sorted ascending (thus from low to high). If you want a descending sort (from high to low), you have to use DESC. o [FD|DF|MIX] The files and directories can be printed at three different places in the listing. You can select the appropriate format by using one of the following arguments : - 'FD' : (default) print files first, directories last. - 'DF' : print directories first, files last. DirKing v2.1xe (English) User Manual - Page 17 - 'MIX' : print files and directories among each other. §6 Listing formatting. ~~~~~~~~~~~~~~~~~~~ The format of the actual listing can be either a table format or a script format. Most of the time, however, you'll use the table format. A. Listing table formatting. A.1. Setting the listing table width. o [MAXWIDTH <#>] DirKing will expand the listing table in accordance with the fields to be printed, and the length of the FileName field. In most cases, you'll want to set a limit to this expanding. With 'MAXWIDTH' you can specify how many characters may be printed on one line. If the listing is too wide, then if the name field is printed, it will be cut (the name field is the only field that can be trimmed, all other fields have a fixed length). If the name of a file or directory should be too long to fit in the FileName field, then the last character will be an '$' to indicate that more characters are following in that name. Note: the MAXWIDTH option is only effective on the actual listing, not on the listing header or listing end. REMARK: the limit set with 'MAXWIDTH' won't work in all cases. This depends on the fields to be printed. The fields that have a fixed length will always be fully printed. The only variable field is the 'FileName' field, but it can't be smaller than 16 characters. DirKing will always print the fixed fields and the minimal 16 characters, even if the total width exceeds the 'MAXWIDTH' setting. | 'MAXWIDTH 70' : the actual listing width can only be 70 | characters wide. o [EXPAND] By default, DirKing will only print as wide as is necessary to print all the wanted fields. So the listing width will vary from directory to directory. If you want DirKing to make use of the full allowed listing width, then you must use EXPAND. When MAXWIDTH is used, then DirKing will print a listing with an actual width as specified. When you don't use MAXWIDTH, then DirKing will use the default width of 77 characters. A.2. Formatting the listing table. With the following options you can customize the format of the listing table, and the format of the date- and timestamp. All these format options, support the use of AmigaDOS print control sequences. To introduce such a sequence in the formatstring, you have to use a '\' character followed by one of the following codes : DirKing v2.1xe (English) User Manual - Page 18 - e : insert an ESCape character (refer to your AmigaDOS manual for a list of the supported print control sequences); - t : insert a TAB character; - n : insert a line feed; - ' : print a double quotation mark ("); - \ : used to print '\'. o [LISTORD <fmt>] Normally the listing is printed in the form of a table, where each column represents a field. By default the fields are printed in the following order : name, keys, blocks, bytes, attributes (protectionflags), date and time (if there's a comment, then it's printed on the next line). With the following codes you can define the order of the fields : - N : 'FileName'; - K : 'Keys'; - B : 'Blocks,; - L : 'Bytes,; - A : 'Flags'; - S : 'Date'; - T : 'Time'. | 'LISTORD dalnktb' : defines the order : date, flags, | bytes, name, keys, time and blocks. Note: the use of LISTORD doesn't mean that these fields will actually be printed. This depends on the options as described under '§4C'. Important: as mentioned above the default order is 'nkbladt'. When defining the fields order, you don't have to enter all codes for the fields that will be printed. When you only define the order of the first fields, DirKing will use the default order for the rest of the fields. | 'LISTORD an' : only two fields are defined, the rest are | printed in the default order. The order | will then be : flags, name, keys, blocks, | bytes, date and time. As mentioned earlier, the LISTORD will also support the use of AmigaDOS print control sequences. You can also use normal text, although this isn't much recommandable since it can disrupt the listing table. So it's best to only use print control sequences. | 'LISTORD \e[1mN\e[0m' : all names will be printed in bold | style characters. The other fields are printed in the | usual default order, and in plain text. | 'LISTORD nkbladt' : same as the default order. DirKing v2.1xe (English) User Manual - Page 19 o [DFORMAT <fmtstr>] DirKing uses the AmigaDOS dateformat (which is DD-MMM-YY) as its default format. With 'DFORMAT' you can define your own dateformat. This formatstring can contain normal text, print control sequences and of course the date substitution operators. The substitution operators indicate which date item has to be printed. Such an operator consists of an '%' character and one of the following date item codes : - w : insert a two character dayname (e.g.Sa,Su,Mo,...); - W : insert the full dayname (e.g.Sunday,Monday,...); - d : insert the day in the month; - m : insert the month number (1..12); - M : insert a three character month name (e.g.Jul,Aug,...); - y : insert the last two digits of the year (e.g.91,92,...); - Y : insert a four digit year (e.g.1991,1992,...). | 'DFORMAT %w_%d/%Y/%m' : gives a date like Su_23/1992/08. | 'DFORMAT "\e[1m%W\e[0m \e[3m%d %M %Y\e[0m"' (Notice the | quotation marks! They're used because the DFORMAT data- | argument contains spaces!) | The defined date format will result in a date looking like | this : 'Friday 11 Sep 1992' Note. The TFORMAT codes are also supported with DFORMAT. o [TFORMAT <fmtstr>] Everything said for DFORMAT is true for TFORMAT, the only difference is the specific set of time item codes : - H : insert the hour in 24 hour mode (0..23); - h : insert the hour in 12 hour mode (0..11); - i : insert the minutes; - s : insert the seconds; - T : insert AM or PM according to the hour ('T' works independent from 'H' and 'h', in other words you don't have to use 12 hour mode to use AM/PM!). | 'TFORMAT %h:%m_%T' : gives time like '08:53_AM'. | 'TFORMAT \e[1m%h\e[0m:\e[3m%i\e[0m:\e[4m%s\e[0m' : gives a | time like : '14:30:18'. Note. The DFORMAT codes are also supported with TFORMAT. B. Predefined listing table formats. As a shortcut, DirKing has several predefined formats, for selecting a listing order, a date- or timeformat. These predefined formats can be accessed by their appropriate code. o [LISTF <code 0..4>] The following listing order formats are supported : - 0 : NKBLADT (default) - 1 : NAKLBDT DirKing v2.1xe (English) User Manual - Page 20 - 2 : NADTLBK - 3 : NDALBKT - 4 : ALBKDTN o [DATEF <code 0..7>] The following dateformats are supported : - 0 : '%d-%M-%y' -> DOS format dd-mmm-yy (e.g. '14-Aug-92') - 1 : '%y-%M-%d' -> INT format yy-mmm-dd (e.g. '92-Aug-14') - 2 : '%m-%d-%y' -> USA format mm-dd-yy (e.g. '08-14-92') - 3 : '%d-%m-%y' -> CDN format dd-mm-yy (e.g. '14-08-92') - 4 : '%w %d-%M-%y' -> (DOS format - e.g. 'Fr 11-Sep-92') - 5 : '%w %y-%M-%d' -> (INT format - e.g. 'Fr 92-Sep-11') - 6 : '%w %m-%d-%y' -> (USA format - e.g. 'Fr 09-11-92') - 7 : '%w %d-%m-%Y' -> (CDN format - e.g. 'Fr 11-09-92') o [TIMEF <code 0..3>] The following timeformats are supported : - 0 : '%H:%i:%s' (e.g. '14:30:00' ) - 1 : '%h:%i:%s-%T' (e.g. '02:30:00 PM') - 2 : '%H:%i' (e.g. '14:30') - 3 : '%h:%i-%T' (e.g. '02:30 PM') C. Free formatting and script generation. -> [LFORMAT <fmtstr>] LFORMAT is the only way to have full control on the actual listing print format. I say 'actual listing' because when LFORMAT is used, no listing head, title or end will be printed. The main use of LFORMAT will probable be the generation of scripts, but you don't have to limit it to this. IMPORTANT : LFORMAT MUST ALWAYS BE THE LAST ARGUMENT, SINCE EVERYTHING AFTER THE LFORMAT KEYWORD IS PART OF THE FORMAT STRING!! (This means that quotation marks may only be used if they're needed in the output!) The 'LFORMAT' option works in the same way as in the AmigaDOS 'List' command, so you should have no difficulties to understand the use of it. The format string can contain three sorts of text. Firstly normal text, secondly the substitution operators (like '%S' or '%N'), and thirdly AmigaDOS print control sequences (refer to the previous explanation on the use of these in format strings). Like the AmigaDOS command 'List', DirKing uses two sorts of substitution operators : a. Usage of '%S' operators. The usage of '%S' substitution operators is limited, because you only have access to the name and path of directory entries (files/directories). To know where and what information to print, DirKing uses the followig table of '%S' occurences : Occurences 1st 2nd 3rd 4th 5th 6th... 1 name - - - - - 2 path name - - - - DirKing v2.1xe (English) User Manual - Page 21 Occurences 1st 2nd 3rd 4th 5th 6th... 3 name path name - - - 4 path name path name - - 5 name path name path name - 6 path name path name path name ... | 'LFORMAT Path:[%s] Name:[%s]' : Just try this format- | string on a directory and see the magic. Note that no | quotation marks were used, since these aren't needed for | LFORMAT, unless you want them in the output! b. Usage of field specific operators. The usage of '%S' substitution operators isn't really recommended since its range is limited, and the format string can sometimes be hard to read if many operators are used. It's better to use the field specific operators, since you can exactly specify which field to print, and where to print it. DirKing supports the same field substitution operators as the AmigaDOS command 'List'. These operators consist of a '%' character followed by one of the following codes : - N : print file/directory name; - K : print file/directory diskkey; - B : print filesize in blocks ('Dir' is used for dirs.); - L : print filesize in bytes ('Dir' is used for dirs.); - A : print file/directory attributes (protectionflags); - D : print file/directory datestamp; - T : print file/directory timestamp; - C : print file/directory filenote (comment); prints an empty string if no comment is present; - P : print the path of the file or directory, relative to the scanned path; - F : print the full path name of the file or directory (thus beginning with the volume name). | Assume current directory is 'Workbench:Devs' | 'DirKing keymaps LFORMAT File:[%N] Path:[%P] FullP:[%F]' | DirKing will read the 'Workbench:Devs/KeyMaps' directory. | The output can then be something like this : | 'File:[usa] Path:[] FullP:[KeyMaps/]' | If you also use FULLPATH in the command line then the | output will be : | 'File:[usa] Path:[] FullP:[Workbench:Devs/KeyMaps/]' | 'DirKing TO RAM:script FILES LFORMAT RENAME %N %N.iff' : | This will generate a script in the 'RAM:' disk. When | executed, the rename commands will add an 'iff' suffix to | the name of files found in the current directory. §7 DirKing MULTI-mode (multiple directory scanning). -> [MULTI] ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The MULTI mode was implemented to present a more flexible way of scanning several disks in a row. If DirKing is first started with MULTI in its command line, then the directory will immediately be read. When the listing has been printed, instead of breaking off, DirKing will print a prompt giving the choice between the following operations : DirKing v2.1xe (English) User Manual - Page 22 - S : start scanning the directory. If you want to read several disks, then you must use a drive name as the path (e.g. 'DF1:'). DirKing will then always scan the disk in drive 'DF1:'. (Otherwise if you type the name of a disk like 'Workbench:', then each time you press 'S' to reply the MULTI prompt, DirKing will always access that disk.) The only time MULTI mode is useful when you've specified a path other than a drive name, is for printing several copies of that directory. - Q : quit DirKing. - A : let's you enter new DirKing arguments, just like you would when starting DirKing. It's important to know that you don't have to type 'DirKing' anymore, since you aren't starting the program! Only type the arguments. REMARK: when you don't type anything when DirKing asks for new arguments, then the old arguments will be used again. Note: you don't have to type MULTI anymore, since DirKing will stay in MULTI mode until an error occurs, or you want to quit the program. - U : will print the DirKing usage prompt, so you would know the correct syntax before entering new arguments. §8 Listing styles. ~~~~~~~~~~~~~~~ DirKing normally prints the files in plain characters, and the directories in italic. The directory entries are also indented to show the structure of the directory. A. Information format. o [SHOWLEVEL] Instead of indenting with spaces (' '), DirKing will indent with '__' for files and '_/' for directories. SHOWLEVEL is very useful to get a clear view of the directory tree structure. | 'DirKing RAM: SHOWLEVEL ALL DIRS' : you'll get a clear | view of the directory tree of your 'Ram Disk'. Note that | the use of DIRS forces DirKing only to include | directories. o [BINFLAGS] By default DirKing uses 'hsparwed' to represent the file- and directory attributes (protectionflags). BINFLAGS will result in a binary value representation (e.g. 00010000) of these attributes. DirKing v2.1xe (English) User Manual - Page 23 o [DATES] Like the AmigaDOS command 'List', DirKing will use the daynames (Sunday...Saturday) of the dates if they're within the last week of the current date. Besides these 'Yesterday','Today','Tomorrow' and 'Future' are also used. You can disable this by using 'DATES'. This forces DirKing to print all dates in the same date format (the default is DD-MMM- YY). o [HEXVAL] Normally all values printed in the listing are in their decimal notation. Using 'HEXVAL' instructs DirKing to use the hexadecimal notation instead. B. Listing print styles. The following options define in which style the entire listig is printed, and also how the directory entries themselves will be printed. o [DIRSTYLE [r|i|b|y|f|a|e][r|i|b|y|f|a|e]] The default print style for files is plain text, while directories use italics. These styles can be altered by using predifined style codes. Only the first two characters of the 'DIRSTYLE's data-argument will be used, where the first character gives the style for directories, and the second for files. (One character data-arguments are also valid, the files will then be printed in their default style, while the directories will use the specified style.) The following character style codes are supported : - R : Red - I : Italic - B : Bold - Y : Yuppy -> Red/Italic - F : Fat -> Red/Bold - A : All -> Red/Italic/Bold - E : Elite -> Italic/Bold - N : Normal (plain) Note: DIRSTYLEs determine in which style a directory entry will be printed. If you want to print a specific field in another style, then you must make use of AmigaDOS print control sequences with the LISTORD, DFORMAT, TFORMAT arguments. | 'DIRSTYLE ab' : print the directories in red, italic and | bold characters, and the files in bold | characters. o [PRTSTYLE {rdlbpes}] If the DirKing output is directed to the printer, then the printer style settings won't be changed, unless the following DirKing v2.1xe (English) User Manual - Page 24 codes are given : - R : reset to normal characters - D : print in draft quality - L : print in near_letter_quality - B : print in subscript - P : print in superscript - E : print in elite (12 cpi) - S : print with doublestriking | 'PRTSTYLE de' : print in elite and draft quality. §9 Listing output redirection. ~~~~~~~~~~~~~~~~~~~~~~~~~~~ The default output is to the Shell window where DirKing was started. Although you can use the AmigaDOS redirection (e.g. '>PRT:') to output somewhere else, it's sometimes not recommended. This is the case when you use TRACE for example. If you would use AmigaDOS redirection when TRACE is active, then all TRACE information would be send to this new destination, which isn't what you want. Therefore two redirection arguments were implemented in DirKing to split the output. The DirKing messages (e.g. TRACE information) are printed in the Shell window as usual, but the directory listing will be send to the selected output device. o [PRT] a. General use. As the argument keyword suggest, this redirects the directory listing to the printer ('PRT:'). b. Use in MULTI-mode. When DirKing has to send the directory listing, it first opens a channel to the printer (this is called 'locking'). As you know from the explanation of MULTI, DirKing doesn't break off after printing the directory, instead a prompt is printed. When you reply this prompt with 'S' then DirKing starts scanning again. DirKing will then send this listing again along the previously opened channel. It's important to note that DirKing doesn't close this output channel when in MULTI-mode, since DirKing always uses the same arguments. ONLY when new arguments are entered (the prompt was replied with 'A'), then DirKing will close this output channel (and open a new channel to the new specified output device)! DirKing does this to make sure it always has direct access to the printer, so the listing can be printed without interruptions. o [TO <file>] a. General use. With the 'TO' argument you can send the directory listing anywhere you like, as long as it's a valid AmigaDOS path. DirKing v2.1xe (English) User Manual - Page 25 | 'DirKing DF1: TO RAM:df1' will output the listing of | 'DF1:' to a file in RAM: called 'df1'. | 'TO PRT:' : naturally you can also use the TO argument to | send the directory listing to the printer. b. Use in MULTI-mode. As mentioned with 'PRT', DirKing only opens the output channel once. Only when new arguments are supplied is this channel closed, and another opened if needed. This way of working is extremely useful, since you can send several directory listings to one file. All listings will be placed after one another. | 'DirKing DF1: TO RAM:df1_dirs MULTI' will send all | directory listings of the disks you've inserted in 'DF1:' | to the file in RAM: called 'df1_dirs' c. Use in conjunction with PRT. If only 'TO' is used, then DirKing will save the listing with the Shell control sequences. When you also use 'PRT' then DirKing will use the printer control sequence instead. Let's take a look at the printing of bold characters, to demonstrate the difference between these control sequences : -> Shell control sequences > bold on : 'esc[1m' bold off : 'esc[0m' << -> Print control sequences > bold on : 'esc[1m' bold off : 'esc[22m' << §10 Listing paging. -> [NEWPAGE [[{th}]<#>] ~~~~~~~~~~~~~~~ By default DirKing will print the directory listing in one go. If a long listing is send to a Shell window, then it can be annoying to see it flying by. To prevent this from happening, a paging facility was implemented in DirKing. The NEWPAGE argument can be used in three different ways. Besides this, the effect of 'NEWPAGE' isn't always the same when output is send to the Shell, to a file or to the printer. a. Command : 'NEWPAGE'. When only 'NEWPAGE' is used, and output is redirected by 'PRT' or 'TO <file>' then at the end a new page character will be send. REMARK: the bare 'NEWPAGE' command has no effect when output is send to your Shell window! b. Command : 'NEWPAGE <#>'. NEWPAGE will mostly be used in this way. By adding a value (greater than 10) to the NEWPAGE keyword, you can specify how many lines should be printed on each page. If output is send to your Shell window, then DirKing will DirKing v2.1xe (English) User Manual - Page 26 display a RETURN-prompt when the specified maximum lines has been reached. When RETURN is pressed, the Shell window will be cleared, and the next number of lines will be printed. This process will be repeated until the entire listing has been printed. When output is redirected with 'PRT' or 'TO <file>' then instead of printing a RETURN-prompt in the Shell window, a new page charachter will be inserted in the listing. This means that, if for instance output is send to the printer, that the paper will be ejected, each time the specified number of lines is reached. As with the bare 'NEWPAGE' command, a new page character will be send at the end of the listing. | 'NEWPAGE 20' : only print 20 lines on a page. REMARK: If the given value is less than 10, then the number of lines will be set to 10! c. Command : 'NEWPAGE {ht}' or 'NEWPAGE {ht}<#>'. The NEWPAGE argument also supports two additional options, which are indicated by the following characters (all options can be used at once) and are used in conjunction with the commands as explained in (a.) en (b.) : - H : after the listing header is printed, a new page character will be send. - T : always print a listing title at the beginning of a new page. | 'NEWPAGE h' : after the listing head has been printed, use | a new page to print the actual listing. | 'NEWPAGE ht20' : print the listing header on one page, | then use only 20 lines per page to print | the listing itself. §11 Disk identification coding support. -> [DISKID <str>] ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ a. General use. If you use a catalog tool to keep track of your disk collection, then this feature of DirKing is very useful. It enables you to insert a string (this can be a disk ID used for cataloging your disks, or any other message) in the listing header. REMARK: Most times the DISKID string will contain spaces, in which case you must place the string between double quotation marks. | 'DISKID PD0/00.0000' : this disk ID will be printed in the | header. | 'DISKID "This is a test ID string!"' : prints this string | in the listing header (notice the double quotation marks). DirKing v2.1xe (English) User Manual - Page 27 b. Use in MULTI-mode. The disk ID string that was typed in the command line (thus when starting DirKing from Shell) will only be used once! Each time you reply the MULTI prompt with 'S' (start scanning), DirKing will first ask to enter a new disk ID string (or message) before reading the directory. §12 DirKing program information. -> [VERSION] ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ VERSION simply instructs DirKing to print the version and copyright prompt. DirKing v2.1xe (English) User Manual - Page 28 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ APPENDIX : DIRKING KEYWORD REFERENCE ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Pattern matching . . . . . . . . . . . . . . . . . . . . . . 4 --------------------------------------------------------------- <path|patt>. . . [[F|D|]<path|patt>] . . . . . . . . . . . . 5 ALL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 BARELIST . . . . . . . . . . . . . . . . . . . . . . . . . . 15 BINFLAGS . . . . . . . . . . . . . . . . . . . . . . . . . . 23 DATEF. . . . . . [DATEF <0..7>]. . . . . . . . . . . . . . . 21 DATES. . . . . . . . . . . . . . . . . . . . . . . . . . . . 24 DESC . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 DF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 DFORMAT. . . . . [DFORMAT <fmtstr>]. . . . . . . . . . . . . 20 DIRS . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 DIRSTYLE . . . . [DIRSTYLE [r|i|b|y|f|a|e][r|i|b|y|f|a|e]] . 24 DISKID . . . . . [DISKID <str>]. . . . . . . . . . . . . . . 27 DISKINFO . . . . . . . . . . . . . . . . . . . . . . . . . . 12 DISKUSE. . . . . . . . . . . . . . . . . . . . . . . . . . . 13 ENDMSG . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 EXCL . . . . . . [EXCL {fkbladtc}] . . . . . . . . . . . . . 16 EXPAND . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 FD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 FILES. . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 FROM..TO . . . . [FROM [F|D|]<ch> TO <ch>] . . . . . . . . . 10 FULLPATH . . . . . . . . . . . . . . . . . . . . . . . . . . 14 HEAD . . . . . . [HEAD {fdvpimtse}]. . . . . . . . . . . . . 14 HEXVAL . . . . . . . . . . . . . . . . . . . . . . . . . . . 24 INCL . . . . . . [INCL {fkbladtc}] . . . . . . . . . . . . . 16 LFORMAT. . . . . [LFORMAT <fmtstr>]. . . . . . . . . . . . . 21 LISTF. . . . . . [LISTF <0..4>]. . . . . . . . . . . . . . . 20 LISTORD. . . . . [LISTORD <fmt>] . . . . . . . . . . . . . . 19 MAXHEAD. . . . . . . . . . . . . . . . . . . . . . . . . . . 15 MAXWIDTH . . . . [MAXWIDTH <#>]. . . . . . . . . . . . . . . 18 MIX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 MULTI. . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 NEWPAGE. . . . . [NEWPAGE [[{th}]<#>]] . . . . . . . . . . . 26 NOHEAD . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 NOSORT . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 NOSTAT . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 PASS . . . . . . [PASS [F|D|]<pattern>]. . . . . . . . . . . 9 PATH . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 PRT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 PRTSTYLE . . . . [PRTSTYLE {rdlbpes}]. . . . . . . . . . . . 24 QUICK. . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 READ . . . . . . [READ [F|D|]<pattern>]. . . . . . . . . . . 9 SHOWLEVEL. . . . . . . . . . . . . . . . . . . . . . . . . . 23 SINCE. . . . . . [SINCE "[F|D|]<[DOSdate] [time]>"]. . . . . 11 SORT . . . . . . [SORT {nksadtc}]. . . . . . . . . . . . . . 17 SUB. . . . . . . [SUB [F|D|]<string>]. . . . . . . . . . . . 10 TFORMAT. . . . . [TFORMAT <fmtstr>]. . . . . . . . . . . . . 20 TIMEF. . . . . . [TIMEF <0..3>]. . . . . . . . . . . . . . . 21 TO . . . . . . . [TO <file>] . . . . . . . . . . . . . . . . 25 TOLEVEL. . . . . [TOLEVEL <#>] . . . . . . . . . . . . . . . 8 TRACE. . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 UPTO . . . . . . [UPTO "[F|D|]<[DOSdate] [time]>"] . . . . . 11 VERSION. . . . . . . . . . . . . . . . . . . . . . . . . . . 28 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ DirKing v2.12e, Copyright ©1990-1993 by Chris P. Vandierendonck, All Rights Reserved. DirKing v2.1xe (English) User Manual - Page 29